docs: improve the documentation of GtkEntry:attributes

See the implementation of gtk_entry_create_layout():
pango_attr_list_splice() is used to add the PangoAttrList of the preedit
string. And that is done *after* applying the PangoAttrList of the
"attributes" property.

https://bugzilla.gnome.org/show_bug.cgi?id=776868

diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 4bc0be217d388436852da5ef57899b6238c88841..2a04129483c6819f24872f59454b2842946d9df1 100644 (file)
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -1378,6 +1378,9 @@ gtk_entry_class_init (GtkEntryClass *class)
    *
    * This is mainly useful to change the size or weight of the text.
    *
+   * The #PangoAttribute's @start_index and @end_index must refer to the
+   * #GtkEntryBuffer text, i.e. without the preedit string.
+   *
    * Since: 3.6
    */
   entry_props[PROP_ATTRIBUTES] =